home *** CD-ROM | disk | FTP | other *** search
-
-
-
- CCCCVVVVIIIINNNNSSSSTTTTRRRR((((1111)))) CCCCVVVVIIIINNNNSSSSTTTTRRRR((((1111))))
-
-
-
- NNNNAAAAMMMMEEEE
- cvinstr - add WorkShop Performance instrumentation code to a program
-
- SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
- ccccvvvviiiinnnnssssttttrrrr [ options ] in_prog_name
-
- DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
- _c_v_i_n_s_t_r is a program which reads an executable program, and writes an
- equivalent program containing additional instrumentation code used for
- performance measurment of the executable. The additional code either
- maintains an array of counts representing the number of times various
- elements of the program are executed, or the number of statistical
- samples that found the PC at various values, or both. If the target
- program uses dynamic shared libraries, they are also instrumented.
-
- Normally, _c_v_i_n_s_t_r is invoked during the data collection phase of WorkShop
- Performance tools; it is not intended to be explicitly invoked by a user.
-
- Options are available: (a) to specify that _c_v_i_n_s_t_r count executions of
- each call-site in the program and the first block in each function only;
- (b) to specify execution counts for all basic blocks within the program;
- and/or (c) to instrument to enable statistical PC sampling for the
- program. Any combination of these options, or none of them may be
- specified.
-
- In the context of _c_v_i_n_s_t_r, a basic block is a region of the program that
- can be entered only at the beginning and exited only at the end; these
- are defined in terms of the instructions in the object program, not in
- terms of basic-blocks defined by the compiler in terms of the source
- code. If basic block counting is specified, enough information is
- provided to compute exact instruction counts for the program and each of
- its functions, as well as to compute execution counts for each source
- line in the program. If only function/call-site counts are taken, these
- computations cannot be performed.
-
- A program instrumented for full basic block counting will run
- approximately 2-3 times slower than the original; a program instrumented
- for function/call-site counting will run about 50-100% slower. Actual
- slowdowns will vary with the nature of the program.
-
- In addition to the instrumented executable and its libraries, _c_v_i_n_s_t_r
- generates a Log file that summarizes various characteristics of the
- program and its shared libraries. All files are written to a single
- directory, named by the ----DDDD argument to the command.
-
- _c_v_i_n_s_t_r supports the caching of instrumented Dynamic Shared Objects.
- When a DSO is instrumented, it is saved in the directory specified by the
- environment variable CVINSTRLIB. Experiment directories will contain
- symbolic links to the DSO cache directory. Caching is enabled by default
- and may be turned off by the -noreuse and -noupdate options.
-
-
-
-
-
- PPPPaaaaggggeeee 1111
-
-
-
-
-
-
- CCCCVVVVIIIINNNNSSSSTTTTRRRR((((1111)))) CCCCVVVVIIIINNNNSSSSTTTTRRRR((((1111))))
-
-
-
- CCCCVVVVIIIINNNNSSSSTTTTRRRR OOOOPPPPTTTTIIIIOOOONNNNSSSS
- ----[[[[nnnnoooo]]]]vvvveeeerrrrbbbboooosssseeee
- Set verbose mode; _c_v_i_n_s_t_r will print out detailed information to the
- .Log file. Default: ----vvvveeeerrrrbbbboooosssseeee
-
- ----[[[[nnnnoooo]]]]ppppccccssssaaaammmmpppplllleeee
- Instrument the program to invoke PC sampling at start-up time.
- Default: ----nnnnooooppppccccssssaaaammmmpppplllleeee
-
- ----[[[[nnnnoooo]]]]ffffccccnnnnccccoooouuuunnnnttttssss
- Generate counts for all call-sites and the first basic block of each
- function only. Default: ----nnnnooooffffccccnnnnccccoooouuuunnnnttttssss
-
- ----[[[[nnnnoooo]]]]bbbbbbbbccccoooouuuunnnnttttssss
- Generate function and basic-block counts. Default: ----bbbbbbbbccccoooouuuunnnnttttssss
-
- ----DDDD _o_u_t_p_u_t__d_i_r_e_c_t_o_r_y
- Specify a directory for writing the output file. Default is current
- directory, "./".
-
- ----oooo _o_u_t__p_r_o_g__n_a_m_e
- Specify a name for the translation. Default is to remove any
- leading directory names from the in_prog_name and append "_Instr" to
- the name.
-
- The following options are provided for use by WorkShop/Tester.
-
- ----ccccoooovvvveeeerrrraaaaggggeeee _n_a_m_e
- Name of the coverage file. This is a command file where complex
- selection critera can be specified. The ability to trace function
- arguments and function return values is also provided.
-
- ----[[[[nnnnoooo]]]]bbbbrrrraaaannnncccchhhhccccoooouuuunnnnttttssss
- Generate a count bin for each taken branch in the program. Default:
- ----bbbbrrrraaaannnncccchhhhccccoooouuuunnnnttttssss
-
- SSSSEEEEEEEE AAAALLLLSSSSOOOO
- cvperf(1)
-
- BBBBUUUUGGGGSSSS
- _c_v_i_n_s_t_r cannot handle stripped programs; it will give a message warning
- the user if it is invoked on a stripped executable.
-
-
-
-
-
-
-
-
-
-
- PPPPaaaaggggeeee 2222
-
-
-
-